home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmStringDrawUnderline.z / XmStringDrawUnderline
Text File  |  1998-10-30  |  7KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggDDDDrrrraaaawwwwUUUUnnnnddddeeeerrrrlllliiiinnnneeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSttttrrrriiiinnnnggggDDDDrrrraaaawwwwUUUUnnnnddddeeeerrrrlllliiiinnnneeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggDDDDrrrraaaawwwwUUUUnnnnddddeeeerrrrlllliiiinnnneeee - A compound string function that
  10.           underlines a string drawn in an X Window
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/Xm.h>
  14.           vvvvooooiiiidddd XXXXmmmmSSSSttttrrrriiiinnnnggggDDDDrrrraaaawwwwUUUUnnnnddddeeeerrrrlllliiiinnnneeee(
  15.           DDDDiiiissssppppllllaaaayyyy **** dddd,
  16.           WWWWiiiinnnnddddoooowwww wwww,
  17.           XXXXmmmmRRRReeeennnnddddeeeerrrrTTTTaaaabbbblllleeee rrrreeeennnnddddeeeerrrrttttaaaabbbblllleeee,
  18.           XXXXmmmmSSSSttttrrrriiiinnnngggg ssssttttrrrriiiinnnngggg,
  19.           GGGGCCCC ggggcccc,
  20.           PPPPoooossssiiiittttiiiioooonnnn xxxx,
  21.           PPPPoooossssiiiittttiiiioooonnnn yyyy,
  22.           DDDDiiiimmmmeeeennnnssssiiiioooonnnn wwwwiiiiddddtttthhhh,
  23.           uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr aaaalllliiiiggggnnnnmmmmeeeennnntttt,
  24.           uuuunnnnssssiiiiggggnnnneeeedddd cccchhhhaaaarrrr llllaaaayyyyoooouuuutttt____ddddiiiirrrreeeeccccttttiiiioooonnnn,
  25.           XXXXRRRReeeeccccttttaaaannnngggglllleeee **** cccclllliiiipppp,
  26.           XXXXmmmmSSSSttttrrrriiiinnnngggg uuuunnnnddddeeeerrrrlllliiiinnnneeee);
  27.  
  28.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  29.           This page documents Motif 2.1.
  30.  
  31.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  32.           XXXXmmmmSSSSttttrrrriiiinnnnggggDDDDrrrraaaawwwwUUUUnnnnddddeeeerrrrlllliiiinnnneeee draws a compound string in an X
  33.           Window. If the substring identified by _u_n_d_e_r_l_i_n_e can be
  34.           matched in _s_t_r_i_n_g, the substring will be underlined. Once a
  35.           match has occurred, no further matches or underlining will
  36.           be done.  Only the first text component of _u_n_d_e_r_l_i_n_e is used
  37.           for matching.
  38.  
  39.           If a compound string segment uses a rendition that contains
  40.           a font set, the graphic context passed to this routine will
  41.           have the GC font member left in an undefined state. The
  42.           underlying XXXXmmmmbbbbSSSSttttrrrriiiinnnnggggDDDDrrrraaaawwww function called by this routine
  43.           modifies the font ID field of the GC passed into it and does
  44.           not attempt to restore the font ID to the incoming value. If
  45.           the compound string segment is not drawn using a font set,
  46.           the graphic context must contain a valid font member.
  47.           Graphic contexts created by XXXXttttGGGGeeeettttGGGGCCCC are not accepted by this
  48.           routine; instead, use XXXXttttAAAAllllllllooooccccaaaatttteeeeGGGGCCCCto create a graphic
  49.           context.
  50.  
  51.           _d         Specifies the display.
  52.  
  53.           _w         Specifies the window.
  54.  
  55.           _r_e_n_d_e_r_t_a_b_l_e
  56.                     Specifies the render table.
  57.  
  58.           _s_t_r_i_n_g    Specifies the string.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmSSSSttttrrrriiiinnnnggggDDDDrrrraaaawwwwUUUUnnnnddddeeeerrrrlllliiiinnnneeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmSSSSttttrrrriiiinnnnggggDDDDrrrraaaawwwwUUUUnnnnddddeeeerrrrlllliiiinnnneeee((((3333XXXX))))
  71.  
  72.  
  73.  
  74.           _g_c        Specifies the graphics context to use.
  75.  
  76.           _x         Specifies a coordinate of the rectangle that will
  77.                     contain the displayed compound string.
  78.  
  79.           _y         Specifies a coordinate of the rectangle that will
  80.                     contain the displayed compound string.
  81.  
  82.           _w_i_d_t_h     Specifies the width of the rectangle that will
  83.                     contain the displayed compound string.
  84.  
  85.           _a_l_i_g_n_m_e_n_t Specifies how the string will be aligned within
  86.                     the specified rectangle.  It is one of
  87.                     XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG, XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____CCCCEEEENNNNTTTTEEEERRRR, or
  88.                     XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____EEEENNNNDDDD.
  89.  
  90.           _l_a_y_o_u_t__d_i_r_e_c_t_i_o_n
  91.                     Controls the direction in which the segments of
  92.                     the compound string will be laid out. It also
  93.                     determines the meaning of the _a_l_i_g_n_m_e_n_t parameter.
  94.  
  95.           _c_l_i_p      Allows the application to restrict the area into
  96.                     which the compound string will be drawn.  If it is
  97.                     NULL, clipping will be determined by the GC.
  98.  
  99.           _u_n_d_e_r_l_i_n_e Specifies the substring to be underlined.
  100.  
  101.      RRRREEEELLLLAAAATTTTEEEEDDDD
  102.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee(3).
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.